home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Disktools / SCSIMounter / SCSIMounter.doc < prev    next >
Text File  |  1996-09-26  |  17KB  |  515 lines
  1. SCSIMounter 2.0
  2. ===============
  3.  
  4. Removable media partition mounter for Kickstart 2.0 or higher.
  5.  
  6. Refer to 'SCSIMounter.guide' for an AmigaGuide version of this
  7. document.
  8.  
  9. WANTED: Someone who translates this document to German!
  10.  
  11. ------------------------------------------------------------------------
  12. Versions
  13. --------
  14.  
  15. 2.02 - Terrible bug fixed which caused SCSIMounter to fail on 68000
  16.        machines.
  17. 2.00 - SCSIMounter is a commodity now
  18.        bi-lingual user interface
  19. 1.30 - MASK tooltype added
  20. 1.20 - Minor changes to the CLI interface. New tool type 'NOUNMOUNT'
  21. 1.10 - ReadArgs() CLI Interface added
  22. 1.04 - Now works with beta kickstarts (V 36)
  23.        Keyboard equivalents for everything (including list view)
  24.        Layout bug fixed
  25.        No funtional changes.
  26. 1.03 - Made more tolerant :-)
  27. 1.02 - Fix for gvpscsi.device (GVP Series II) added.
  28.  
  29.  
  30. ------------------------------------------------------------------------
  31. Disclaimer
  32. ----------
  33.  
  34. SCSIMounter may be freely distributed for non-commercial purposes only. 
  35. The entire risk as to the quality and performance of this program is 
  36. with you. 
  37.  
  38. The author assumes no responsibility or liability whatsoever with
  39. respect to your use or inability to use of this software.
  40.  
  41.  
  42. ------------------------------------------------------------------------
  43. Purpose
  44. -------
  45.  
  46. Most owners of removable media SCSI drives are stuck with the problem
  47. that their software doesn't handle disk changes correctly.
  48. For example, the current Commodore implementation doesn't mount the 
  49. partitions on a removable media SCSI drive (e.g. SyQuest or Ricoh)
  50. when there was no cartridge in the drive at boot time. 
  51.  
  52. Even worse, after another cartridge with a different Rigid Disk Block 
  53. (i.e. a different partition table) has been inserted, the system
  54. gets totally confused and reports read/write errors when trying
  55. to access the device which can lead to loss of important data on 
  56. the cartridge.
  57.  
  58. Until now, the only possibility to work around this problem was to
  59. reboot the system every time a new cartridge has been inserted.
  60.  
  61. SCSIMounter allows you to mount and unmount partitions without rebooting 
  62. the machine. It sports a nice 2.0-style point-and-click user interface
  63. that makes handling removable media a piece of cake.
  64.  
  65.  
  66. ------------------------------------------------------------------------
  67. Secondary use
  68. -------------
  69.  
  70. SCSIMounter can also be used to mount partitions that have intentionally
  71. not been mounted (e.g. the wb_1.3: partition on an A3000 when running 
  72. under 2.0). You don't have to create a mountlist for it! 
  73.  
  74.  
  75. ------------------------------------------------------------------------
  76. Requirements
  77. ------------
  78.  
  79. · Any Amiga with a SCSI host adaptor that supports the Commodore
  80.   RDB (Rigid Disk Block) and 'SCSI Direct' standards.
  81. · Kickstart 2.0 or higher (version 37.175 preferred)
  82.  
  83. The program has been tested on an A3000 with Commodore's scsi.device
  84. and on an A2500 with a Microbotics HardFrame (HardFrame.device) but
  85. I see no reason why it shouldn't work on any other host adaptor. 
  86.  
  87. The program may be of no use for owners of certain GVP controllers 
  88. which support removable media correctly (Though not all GVP software 
  89. might do so).
  90.  
  91.  
  92. ------------------------------------------------------------------------
  93. Before you begin
  94. ----------------
  95.  
  96. First, determine the name of the device driver of your hard disk 
  97. controller card. 
  98.  
  99.     Examples of popular controllers and their devices:
  100.  
  101.     manufacturer/controller           device
  102.     --------------------------------------------------
  103.     Commodore A590/A2091/A3000        scsi.device
  104.     Old GVP                           scsidev.device
  105.     GVP Series II                     gvpscsi.device
  106.     Supra SupraDrive                  harddisk.device
  107.     Advanced Storage Systems Nexus    nexus.device
  108.     Microbotics HardFrame             HardFrame.device
  109.     ICD AdSCSI                        icddisk.device
  110.     IVS Trumpcard Professional        ivs_scsi.device
  111.     BSC ALF2/3                        ALF.device
  112.     BSC Oktagon 2008                  Oktagon.device
  113.     --------------------------------------------------
  114.  
  115. Click once one the SCSIMounter icon and select 'Information' from the
  116. 'Icons' menu.
  117.  
  118. Add or change the following tool type:
  119.  
  120.     DEVICE=Name_of_your_scsi_device_here
  121.  
  122. for example if you use a HardFrame controller write:
  123.  
  124.     DEVICE=HardFrame.device
  125.  
  126. Don't add path names here, only the name of the device is required.
  127. Take care to capitalize the device name correctly (exec device names 
  128. are case sensitive!)
  129.  
  130. NOTE
  131.  
  132. SCSIMounter will not work with the Commodore A2090(A) controller card
  133. because this product does not support Commodore's own 'SCSI direct' and
  134. 'RDB' standards properly.
  135.  
  136.  
  137. ------------------------------------------------------------------------
  138. Start SCSIMounter
  139. -----------------
  140.  
  141. SCSIMounter can be used either from Workbench or from the CLI.
  142.  
  143.  
  144. * Workbench use
  145.  
  146.   Double click on the SCSIMounter icon. After a short time, a window
  147.   with a listview and three buttons will appear (assuming CX_POPUP
  148.   is set to `yes'). If the window doesn't appear several things could 
  149.   have gone wrong:
  150.  
  151.   · Do you use Kickstart 2.0 or higher?
  152.   · Did you specify and spell the name of your device driver correctly?
  153.   · Does your host adaptor support RDB?
  154.   · Is there any memory left on your system?
  155.   · Do you have commodities.library (supplied with Workbench 2.04)
  156.     in libs:?
  157.  
  158.   Requesters will try to tell you the cause if SCSIMounter fails to run.
  159.  
  160.  
  161. * CLI use
  162.  
  163.   Type 'SCSIMounter gui device Name_of_your_scsi_device'
  164.   example:
  165.  
  166.   1> SCSIMounter gui device HardFrame.device
  167.  
  168.   If the 'gui' argument is not given, SCSIMounter will be started
  169.   in command line mode as described later in this document.
  170.  
  171.  
  172. ------------------------------------------------------------------------
  173. Panels
  174. ------
  175.  
  176. 1) Main panel
  177.  
  178.    The main panels shows all devices connected to the SCSI port with
  179.    information about their capacity and current status. The currently 
  180.    selected unit is higlighted.
  181.  
  182.    UNIT - This is the unit number of a SCSI device.
  183.           Up to seven devices can be connected to the SCSI bus
  184.  
  185.    DRIVE TYPE - Manufacturer and product specification
  186.  
  187.    REV. - Revision of Hardware, Firmware and ROM of device
  188.  
  189.    CAP. - Device capacity in Megabytes or Kilobytes
  190.  
  191.    STATUS - Current Status of device. If the device is busy or
  192.             not accessable due to the lack of media (if it's a
  193.             removable media drive) the status will be set to
  194.             'not ready'
  195.  
  196.    There are three 'action buttons' present:
  197.  
  198.    HIDE - Put SCSIMounter to sleep. To wake it up again, use the
  199.           hotkey as specified in CX_POPKEY or the Commodities Exchange
  200.           program on you system partition. Closing the window
  201.           using its closegadget has the same effect.
  202.  
  203.    UPDATE - Re-scan SCSI bus and update display
  204.  
  205.    MOUNT - Mount partitions on selected drive
  206.  
  207.    For every action buttons there's also a menu item with identical
  208.    function. All buttons have keyboard equivalents (marked with an
  209.    underscore in the label text). The listview can be scrolled using
  210.    the arrow up and arrow down keys on your keyboard rather than using
  211.    the mouse.
  212.  
  213.    There's one important menu item that has no button equivalent:
  214.  
  215.    QUIT - Quits SCSIMounter and removes it from the list of commodity
  216.           programs
  217.  
  218.  
  219. 2) 'Partition Selector' panel
  220.  
  221.    This panel shows all available partitions and allows you to 
  222.    individually mount them.
  223.  
  224.    CHECKGADGETS - Determine if the particular partition should 
  225.                   be mounted or not.
  226.  
  227.                   checked: mount corresponding partition
  228.                   not checked: don't mount specified partition
  229.  
  230.  
  231.    Other partition Information on the partition selector -
  232.  
  233.           Number of Partition == keyboard equivalent
  234.  
  235.           Device name of partitions
  236.  
  237.           Size of partitions
  238.  
  239.           Dostype (FileSystem) of partition
  240.  
  241.              Examples of dostypes:
  242.  
  243.              DOS0 - Old filesystem partition
  244.              DOS1 - FastFileSystem partition
  245.              UNI1 - Unix boot partition
  246.              RESV - Reserved partition
  247.  
  248.    CANCEL - Go back to main panel, don't mount anything
  249.  
  250.    MOUNT - Unmount all currently mounted partitions on the selected
  251.            device and mount the new partitions (if any).
  252.  
  253.    UNMOUNT ALL - If this gadget is checked, SCSIMounter will try
  254.                  to unmount all partitions currently mounted on the
  255.                  selected unit. If there are locks on this device
  256.                  there will be a 'BUSY' icon on your Workbench screen.
  257.  
  258.                  WARNING:
  259.  
  260.                  This option can be dangerous if used with non-removable
  261.                  devices because it will unmount all partitions 
  262.                  including your boot partition (SYS:) forcing you to 
  263.                  reboot your computer. Use it with care!
  264.  
  265.  
  266. ------------------------------------------------------------------------
  267. Operation
  268. ---------
  269.  
  270. SCSIMounter is pretty self-explanatory. Nevertheless, here are some 
  271. basic operation procedures.
  272.  
  273. * Mount a new cartridge
  274.  
  275.   · Click on the listview entry of the desired device. (Make sure its
  276.     status is 'ready')
  277.  
  278.   · Click on the 'Mount' button
  279.  
  280.     The 'select partitions' panel will ask you which partitions to mount
  281.  
  282.   · Chosse the partitions you would like to mount
  283.  
  284.   · Make sure that the 'Unmount all' gadget is checked
  285.  
  286.   · Click on 'Mount' button on the partition selector panel
  287.  
  288.     SCSIMounter will automatically unmount all existing partitions
  289.     on the device and mount the new partitions.
  290.  
  291.  
  292. * Add a SCSI drive that was not present at boot time
  293.  
  294.   · Click on the 'Update' button
  295.  
  296.     The new drive's name and other information should appear in the 
  297.     listview
  298.  
  299.   · Click on the corresponding entry
  300.   · Click on the 'Mount' button
  301.  
  302.     and so on...
  303.  
  304.  
  305. * Mount a partition that has the automount flag not set
  306.  
  307.   · Click on the listview entry of the desired device. (Make sure its
  308.     status is 'ready')
  309.  
  310.   · Click on the 'Mount' button
  311.  
  312.   · On the partition selector panel, make sure the 'unmount all' check
  313.     gadget is *not* checked
  314.  
  315.   · Select 'Unselect All' from the 'Edit' menu or press 'Rt. Amiga-U'
  316.  
  317.   · Click on the check gadget of the partition(s) to mount
  318.  
  319.   · Click on the 'Mount' gadget or press 'Rt. Amiga-M'
  320.  
  321.  
  322. WARNING !!!
  323.  
  324.     Don't unmount your boot partition (where you system files live) or
  325.     you'll soon be forced to reboot you machine...
  326.  
  327.  
  328. ------------------------------------------------------------------------
  329. Keyboard Equivalents
  330. --------------------
  331.  
  332. * Requesters
  333.  
  334.   gadget         keystroke activation     menu shortcut
  335.   -------------------------------------------------------
  336.   OK             O                        Rt. Amiga-O 
  337.   Cancel         C                        Rt. Amiga-C
  338.  
  339.  
  340. * Main window & Project menu
  341.  
  342.   gadget         keystroke activation     menu shortcut
  343.   -------------------------------------------------------
  344.   About          none                     Rt. Amiga-A
  345.   Mount          M                        Rt. Amiga-M
  346.   Update         U                        Rt. Amiga-U
  347.   Quit           Q                        Rt. Amiga-Q
  348.   Listview up    Arrowkey up              none
  349.   Listview dowm  Arrowkey down            none
  350.  
  351.  
  352. * Partition Selector
  353.  
  354.   gadget         keystroke activation     menu shortcut
  355.   -------------------------------------------------------
  356.   Mount          M                        Rt. Amiga-M
  357.   Cancel         C                        Rt. Amiga-C
  358.   Select All     none                     Rt. Amiga-A
  359.   Unselect All   none                     Rt. Amiga-U
  360.   Partitions     0-9                      none
  361.  
  362.  
  363. ------------------------------------------------------------------------
  364. Tool Types
  365. ----------
  366.  
  367. The following tool types are supported:
  368.  
  369. DEVICE    - See above
  370.  
  371. NOUNMOUNT - If this tool type is set, the 'Unmount All' gadget is not 
  372.             checked by default and other partitions on the same unit are 
  373.             not removed. This option is useful if you don't use
  374.             SCSIMounter with removable media. Dont set this tool type
  375.             for removable media!
  376.  
  377. MASK      - Default DMA Mask. If not specified, the mask in the RDB will 
  378.             be used. Don't specify this tool type unless you know what
  379.             you're doing.
  380.  
  381. CX_POPUP  - If you want the SCSIMounter window to pop up the first time
  382.             you double-click on the SCSIMounter disk icon, set this
  383.             to yes: 
  384.                         CX_POPUP=yes
  385.  
  386.             If you want SCSIMounter to run in the background the first
  387.             time it is being started e.g. if you're running it from the
  388.             WBStartup drawer, set this to no:
  389.                         CX_POPUP=no
  390.  
  391. CX_POPKEY - Key combination for the commodity `hotkey'. Default:
  392.                         CX_POPKEY=alt shift f10
  393.  
  394. CX_PRIORITY Commodity priority. Default value:
  395.                         CX_PRIORITY=0
  396.  
  397. LANGUAGE  - Determines the language to use for the user interface
  398.             Possible values: 
  399.                        LANGUAGE=German
  400.                        LANGUAGE=English
  401.             This tool type overrides global language settings. Remove
  402.             it if you want to use the system's default language...
  403.  
  404. PUBSCREEN - Name of the public screen on which SCSIMounter should open.
  405.  
  406.  
  407. ------------------------------------------------------------------------
  408. Command Line Use
  409. ----------------
  410.  
  411. For the advanced user, SCSIMounter can be used in command line mode 
  412. by specifying all required arguments on the command line. In CLI mode, 
  413. it is not possible to individually select partitions. All partitions on 
  414. the particular unit will be mounted.
  415.  
  416. Note that SCSIMounter will not attempt to open commodities.library
  417. and add itself to the list of commodities in CLI mode except when 
  418. the `GUI' argument (see below for more info) is given.
  419.  
  420. SCSIMounter supports 2.0-style ReadArgs() CLI options. The command 
  421. template looks like that:
  422.  
  423. D=DEVICE/K,U=UNIT/N,N=NOUNMOUNT/S,GUI/S,QUIET/S
  424.  
  425. DEVICE    - Specifies the device used for you hard drive controller
  426.             e.g. scsi.device.
  427.             If this argument is left out, DEVICE defaults to
  428.             'scsi.device'.
  429.  
  430. UNIT      - Specifies the SCSI unit number of the drive to be mounted.
  431.             e.g. 6
  432.             This argument is not required if the GUI option is used.
  433.  
  434. NOUNMOUNT - If this switch is set, SCSIMounter will not unmount old
  435.             partitions. It basically works the same as the 'Unmount All'
  436.             check gadget in the 'partition selector' panel. If you're
  437.             mounting removable cartridges, use this option with care!
  438.  
  439. GUI       - If this keyword is used, SCSIMounter will open its
  440.             'unit selector' panel as if it was started from Workbench.
  441.             
  442. QUIET     - Don't output information on selected unit and mounted
  443.             partition but output fatal error messages. Ideal for use 
  444.             in shell scripts
  445.  
  446. Examples:
  447.  
  448. 1> scsimounter device HardFrame.device unit 6 quiet
  449.  
  450. (mounts all partitions on SCSI unit 6 connected to a HardFrame 
  451. controller and is quiet about device and partitions)
  452.  
  453. 2> scsimounter d u 3
  454. Unit Drive Type                  Rev.    Cap.  Status
  455. 3    SyQuest   SQ555             FGJ     43 M  ready
  456. Unmounting device: sq0                              
  457. Mounting device  : sq0
  458.  
  459. (mounts all partitions on SCSI unit 3 connected to a Commodore
  460. A590/A2091/A3091 controller and unmounts old partitions on the
  461. same unit. Outputs full device and partition information)
  462.  
  463.  
  464. ------------------------------------------------------------------------
  465. Known Problems
  466. --------------
  467.  
  468. · The program only removes the dos entries for the volumes and devices.
  469.   It doesn't remove the filesystem process and associated memory 
  470.   allocations. Apparently the current FS doesn't support the ACTION_DIE
  471.   packet. I'm still looking for a legal way to solve this problem.
  472.  
  473.  
  474. ------------------------------------------------------------------------
  475. Credits
  476. -------
  477.  
  478. Author: Martin A. Blatter
  479.         Pfaffächerstr. 59
  480.         CH-8913 Ottenbach
  481.         Switzerland
  482.  
  483. Work address: Relog AG
  484.               Attn: Martin A. Blatter
  485.               Bruggerweg 2
  486.               CH-8037 Zurich
  487.               Switzerland
  488.  
  489.               (Relog AG develops high quality software for the
  490.               Amiga computer)
  491.  
  492. E-Mail: blatter@amiga.physik.unizh.ch
  493.         cbmvax!cbmehq!cbmswi!zethos!blatter
  494.  
  495. Bug reports or suggestions are welcome. If you find this program useful,
  496. feel free to send a donation to the above address.
  497.  
  498. This program uses Relog's ITools(tm), the object-oriented user interface 
  499. system (c) 1991 by Christian A. Weber and Relog AG.
  500.  
  501. Special thanks to  · Christian A. Weber
  502.                    · Peter Simeon for the SCSI inquiry code
  503.                    · Michael-Wolfgang Hohmann for the AmigaGuide
  504.                      version of the manual.
  505.                    · Andreas F. Bobak for the new icon
  506.  
  507. ------------------------------------------------------------------------
  508. Trademarks
  509. ----------
  510.  
  511. All trademarked product and company names used herein are used for
  512. identification purposes only. No infringement of trademarks is intended.
  513. Trademarks remain property of the trademark holder.
  514.  
  515.